home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbsdoors / dbstat10.zip / DBSTAT.DOC < prev    next >
Text File  |  1993-06-06  |  6KB  |  106 lines
  1.  
  2.                          DoorBill Statistics Generator
  3.                                  Version 1.0a
  4.                           Written By: Garrett Whitney
  5.                              Gamma Software Design
  6.                                 Copyright 1993
  7.  
  8.  
  9.         Thank You for taking the time to obtain a copy of this program and
  10.  I hope you find it useful. Before I tell you what DBSTAT will do, I need
  11.  to say that DBSTAT is Freeware. I am charging no registration fee for its
  12.  use. You may use this program free of charge from the author for any given
  13.  amount of time. The author can not be held responsible for any damage caused
  14.  by DBSTAT. You, the user, assume all responsibility by using this program.
  15.  
  16.         One thing I would like you all to know, instead of asking for money
  17.  as registration, I will instead ask you to send me a short letter with
  18.  comments on how I can improve this program to suit your needs. I also ask
  19.  that you take a look at other programs I have written which are located
  20.  in the GAMMAREG.TXT file. This is not required as registration of this
  21.  program though.
  22.  
  23.         Doorbill Statistics Generator is a simple program that will
  24.  read your Doorbill log file and take out the necessary information to
  25.  create a statistics bulletin. DBSTAT will create an ANSI/ASCii bulletin
  26.  with the top ten door users as well as the top ten doors on your board.
  27.  It is very easy to use and self automated as well.
  28.  
  29.         This is the first release of DBSTAT to the public. This version
  30.  has been tested to a safe degree so you should have nothing to worry about.
  31.  You may encounter a few bugs during operation, please notify me of these
  32.  bugs. Thank you.
  33.  
  34.         Before you do anything, you must initialize DBSTAT. Initialization
  35.  will create a configuration file. After initializing DBSTAT, you will
  36.  not need to worry about ever taking care of it again. The only manual
  37.  part of DBSTAT is the config file. To create the config file, type the
  38.  following on the command line:
  39.  
  40.         DBSTAT INIT
  41.  
  42.         You will then be asked to enter the name of you Bulletin Board as
  43.  well as your name (Sysop Name). These will be used only on the screen
  44.  display in this version but in the next update, they might be in the
  45.  statistics screens as well. The next two questions will be the path and
  46.  name of the statistics files to be created by DBSTAT. DBSTAT creates an
  47.  ANSI file and an ASCii file.
  48.  
  49.         Once you have completed the initialization, you should probably
  50.  setup DBSTAT to run as an event. DBSTAT will take about 5 minutes for
  51.  every 100K in your log file on a 286 class computer with 640K memory.
  52.  That's an average though and also depends on how much memory you have free.
  53.  There are alot of memory sorts and such so the more memory you have free,
  54.  the faster DBSTAT will operate. I know it operates somewhat slow but I am
  55.  working on that problem. I have it setup so DBSTAT tells you exactly what it
  56.  is doing. You are shown the percentage of each file read also. When DBSTAT
  57.  sorts the Users and Doors, the percentage of users that have been written
  58.  to the Data file are shown. If it stops on 88% or anywhere before 100%,
  59.  it is because the rest of the users or doors in the file have been read
  60.  previously so only 88% of the users needed to be written to the data file.
  61.  Don't worry, it is reading your entire file.
  62.  
  63.         If you don't have ANSI capability then you are going to see a bunch
  64.  of garbage at the ending of the program. After DBSTAT has finished, it
  65.  shows off its work by typing up the ANSI file it created and then exiting
  66.  back to the operating system.
  67.  
  68.         There are five files created while DBSTAT is running. A top ten file
  69.  is created as well as two door files and two user files. You can erase
  70.  anything that is created by DBSTAT because it will not be needed during the
  71.  next execution, however, if you leave the files in the directory with
  72.  DBSTAT then during the next execution, sorting routines will go somewhat
  73.  quicker. In the next update I plan on having DBSTAT only read the log
  74.  file from where it left off last time. That will save ALOT of time.
  75.  
  76.         To execute DBSTAT, simply type:
  77.  
  78.         DBSTAT <path + doorbill.log>
  79.  
  80.         The path and logname of your log file are required. If you insist
  81.  on not including these, DBSTAT will do nothing but tell you what you need
  82.  to do. It is pretty simple to operate. One thing you should know,
  83.  DBSTAT opens various files more than once at the same time. If you are
  84.  having problems with DBSTAT, try loading SHARE.EXE and then run it.
  85.  I recommend loading SHARE.EXE before running it but I don't think it
  86.  needs to be loaded up. I have run DBSTAT without SHARE loaded.
  87.  
  88.         I would like to thank Darrell Dillard from Thundercat BBS for
  89.  giving me the necessary data files to write this program as well as
  90.  requesting it to be written. Thundercat BBS (206) 613-0668
  91.  
  92.         Doorbill is a registered trademark of its respective owner.
  93.  
  94.                  Send all comments or what have you to:
  95.  
  96.                          Gamma Software Design
  97.                             Garrett Whitney
  98.                          12809 Johnny Hoss Rd.
  99.                              Bremerton, Wa
  100.                                  98312
  101.  
  102.  ──────────────────────────────────────────────────────────────────────────────
  103.      DoorBill Statistics Generator | Garrett Whitney | Gamma Software Design
  104.  ──────────────────────────────────────────────────────────────────────────────
  105.  
  106.